Status codes

Every API method returns a result code. These are very similar to HTTP errors.

The method result code is always stored in the output structure in variable called status.

Successful 2xx

If the method completed successfully result will be:

• 200 OK
• 206 Partial content; message

Errors

and if there was an error result will be one of these:

• 401 Unauthorized
• 402 Subtitles has invalid format
• 403 SubHashes (content and sent subhash) are not same!
• 404 Subtitles has invalid language!
• 405 Not all mandatory parameters was specified
• 406 No session
• 407 Download limit reached
• 408 Invalid parameters
• 409 Method not found
• 410 Other or unknown error
• 411 Empty or invalid useragent
• 412 %s has invalid format (reason)
• 501 Temporary down
• 503 Service Unavailable
• 301 Moved (to ​http://api.opensubtitles.org/xml-rpc)

---

Notes

• more error code might be added if needed

---

Home